home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Source Code / Visual Basic Source Code.iso / vbsource / storc / storc.rme < prev    next >
Text File  |  1992-09-18  |  11KB  |  306 lines
  1. ************************* Welcome to STORC v1.0! *****************************
  2. Distributors/Sysops: please refer to the end of this file for more information
  3.  
  4. In Short:     'STORC' stands for 'Screen-TO-Resource-Converter'.
  5.  
  6. Environment:     Microsoft Windows 3.x, Standard or Enhanced mode.
  7.  
  8. Purpose:    Converts any window on screen into a dialog resource script
  9.  
  10. Mission:    
  11.     Assists programmers in turning DEMOS written in Visual Basic(tm),
  12.     Object Vision(tm), Power Builder(tm) or any other prototyping tool
  13.     that stores forms in PROPRIETARY format into Windows 3.x
  14.     RESOURCE SCRIPTS!
  15.  
  16. Why Bother:     
  17.  
  18.     After you have created a Highly Polished Prototype using one
  19.     of the high-level tools and it is time to start working on the 
  20.     Real Thing... you probably found out that all your beautiful 
  21.     forms are stored in the format only readable by the tool itself!
  22.     Does that mean the time spent on aligning all those controls
  23.     is wasted forever and you have to start from scratch with a 
  24.     resource editor and a bunch of drawings?
  25.  
  26.     We hope NOT!!!
  27.  
  28. How it all started:
  29.  
  30.     When Visual Basic refused outright to yield us our forms, and we
  31.      had to deliver a number of pretty complicated converted forms and 
  32.     start coding in 2 days, we knew there is no way we could do this 
  33.     in time starting from scratch...
  34.  
  35.     Of course the boss did not know(now he does)...He actually got 
  36.     very happy with the results. Here is how we became heroes and not
  37.     losers: a simple conversion program! Yes! And all the forms got
  38.     converted in a couple of hours... 
  39.  
  40. More about STORC:
  41.  
  42.     Of course the STORC program we offer now is far more capable than
  43.     that original one. It was pretty difficult for anyone else but the
  44.     original author to figure out how to interpret results... Yes, it
  45.     is true that the original program was only converting control 
  46.     coordinates, and not always accurately.
  47.     
  48.     Now STORC also writes out dialog templates, interprets window styles
  49.     and reads in window texts. It has a little editor to help you modify
  50.     what you want, too. The output is ready to be processed by a dialog
  51.     editor (RC, Resource Workshop or any other) with minimal input on your 
  52.     side. And the result is... a dialog template exactly matching your
  53.     form(or any other window on the screen)!
  54.  
  55. Working with STORC 1.0:
  56.           
  57.     Suppose you have a Visual Basic demo product with some forms.
  58.  
  59.     Typically, you would run your demo and launch STORC.EXE.
  60.     To convert a form, you have to have it displayed on the screen,
  61.     so STORC can read it. When you see the form, activate STORC
  62.     and select Window/Find from its main menu. The mouse cursor will
  63.     turn into a special arrow with words 'find window' inside; then 
  64.     STORC minimizes itself to let you see your form. All you have to
  65.     do is click on the form window. Note: when you move the mouse above
  66.     windows, window borders are highlighted to indicate which window 
  67.     will get selected if you click; we recommend clicking on Caption 
  68.     Bars for accuracy. After you click, STORC restores itself with a 
  69.     resource script matching your form in its editor.
  70.      
  71.     You can perform this operation for any number of forms; every time
  72.     the resource script for the new form will be inserted into STORC 
  73.     editor at cursor.
  74.  
  75. More about STORC editor:
  76.      
  77.      The STORC application is built around an editor; its main window
  78.     is actually an edit field, and it has 'file' menu, 'edit' menu and
  79.     'find' menu provide basic functionality of a normal text editor.
  80.     This was done to assist in easy modification of your script.
  81.  
  82. Real-Life conversion options
  83.     
  84.     'Options/TranslateClasses' menu item
  85.  
  86.     As you know, you have to specify a CLASSNAME for every in the DIALOG 
  87.     script. For example, you say 
  88.         CTEXT "Text", -1, 7, 9, 75, 17, WS_CHILD| WS_GROUP
  89.     or (same thing):
  90.         CONTROL "Text", -1, "STATIC", WS_CHILD | WS_GROUP | SS_CENTER,
  91.              7, 9, 75, 17
  92.  
  93.     Many of the tools define their own control styles; for example
  94.     Visual Basic 1.0 defines custom control classes like "ThunderLabel"
  95.     or "ThunderListbox", etc.
  96.     If you decide to convert a form with custom controls to resources and
  97.     then run then from your program, you are likely to get into trouble.
  98.     You either have to use the custom control DLLs you tool uses(and use
  99.     them exactly as they were designed to be used) or provide a substitute
  100.     for custom controls, mapping their classes into standard Windows 
  101.     control classes or your own classes.
  102.  
  103.     STORC 1.0 gives you both options, controlled by 
  104.     'Options/TranslateClasses' menu item. When this menu item is checked,
  105.     the control classes will be translated as defined in [class translation] 
  106.     section of STORC.INI file(described below).
  107.     Otherwise you will see the original class names(which can be an 
  108.     educational experience).
  109.  
  110.     'Options/InterpretStyles' menu option
  111.  
  112.     A window style is a LONG integer value associated with a window.
  113.     It is logically divided into 2 words; high word contains WS_-type
  114.     styles shared by all window types. Low word is window-specific,
  115.     and its meaning is dependent on window class. 
  116.     If 'Options/InterpretStyles' is checked, STORC will make an attempt
  117.     to interpret BOTH parts of window style; of course it only knows
  118.     about styles of standard controls, so it will not interpret the lower
  119.     word of the window style unless 'options/TranslateClasses' is on and
  120.     it could map the control class into one of the standard classes.
  121.     It however would by all means attempt to interpret WS_ styles.
  122.     Uncheck this option if you would like to see a long integer for style
  123.     with no interpretation attempt
  124.  
  125.     'Options/Force Dlg Templates' menu option
  126.                                                
  127.     The DIALOG template allows you to specify CAPTION, CLASS and STYLE
  128.     for the dialog itself. If this menu option is checked, STORC
  129.     will get this information from the form window and put it into the
  130.     dialog template it writes.
  131.  
  132.     However, you will have to register the dialog class to use the 
  133.     resulting template; the custom class dialog style can be improperly
  134.     interpreted, and resulting dialog will be not usable unless you 
  135.     modify it.
  136.  
  137.     We decided to provide 'default' dialog template that definitely will
  138.     compile and run from any user's program. Check this option to 
  139.     force the 'standard' template. 
  140.  
  141. Configuration File Format:
  142.  
  143.     STORC uses the configuration file STORC.INI. The file has to be in 
  144.     the DOS PATH.
  145.     Here is a sample INI file with comments:
  146.  
  147.     ;STORC window coordinates (at time of last close):
  148.  
  149.     [rectangle] 
  150.  
  151.     left=0
  152.     top=0
  153.     right=640
  154.     bottom=480
  155.  
  156.     ;last 'options' menu parameters (at time of last close):
  157.  
  158.     [options]
  159.  
  160.     Translate Classes=0
  161.     Interpret Styles=1
  162.     Force Standard Templates=0
  163.  
  164.     ; classname translation
  165.     ; (this section will be used if 'Translate Classes' option is ON
  166.     ; every key is a 'custom' classname, and its value specifies how
  167.     ; it will be translated. All translations by default map into
  168.     ; standard Windows control classes, but you can change it so that
  169.     ; they map into YOUR custom classes, e.g. if you implement a
  170.     ; class 'BetterListbox' as an equivalent to Visual Basic 
  171.     ; 'ThunderListbox' class, change corresponding line to
  172.     ;    "ThunderListbox=BetterListbox"
  173.  
  174.     [classname translation]
  175.  
  176.     ;Visual Basic custom classes
  177.     
  178.     ThunderLabel=text
  179.     ThunderListbox=listbox
  180.     ThunderTimer=button
  181.     ThunderTextBox=edit
  182.     ThunderCheckBox=button
  183.     ThunderOptionButton=button
  184.     ThunderDriveListBox=listbox
  185.     ThunderDirListBox=listbox
  186.     ThunderFileListBox=listbox
  187.     ThunderFrame=button
  188.     ThunderCommandButton=button
  189.     ThunderComboBox=combobox
  190.     ThunderHScrollBar=scrollbar
  191.     ThunderVScrollBar=scrollbar
  192.     ThunderPictureBox=button
  193.  
  194.     ;Object Vision custom classes
  195.     OVButton=button
  196.     OVSubBar=button
  197.     OVToolBar=button
  198.             
  199.     ;end of STORC.INI
  200.  
  201. Terms:    This package is a DEMO of STORC 1.0, not the actual product! 
  202.     There are indeed some features disabled, and the purpose of 
  203.     this demo is to show you WHAT the actual program does, 
  204.     HOW it does it and WHAT    does the result look like. 
  205.     If you realize this is what you want, you are welcome to buy 
  206.     the actual program.
  207.  
  208.     
  209. How to Get the Real Thing:
  210.  
  211.     Just print